Метод IStringsList::Add

Добавляет новый элемент в список строк.

IDL

[id(102502)]
HRESULT Add(
    [in] BSTR Item, 
    [out, retval] long* Value
);

Параметры

Параметры	Описание
Item	Строка
Value	Возвращаемое значение

Возвращаемое значение

Индекс строки, добавленной в список.

Описание

Если включен режим сортировки (IStringsList::IsSorted), то при добавлении строки список останется упорядоченным по возрастанию.

Если режим сортировки выключен, то строка будет добавлена в конец списка.

Если включен режим уникальности строк (IStringsList::IsUnique), то добавление будет выполнено только в том случае, если добавляемой строки нет в списке.

Сравнение добавляемой строки и строк списка будет регистрозависимым при включенном признаке IStringsList::IsCaseSensitive.

Метод возвращает индекс строки, добавленной в список. Если строка не была добавлена, то возвращает -1.